查询范围

可以对模型的查询和写入操作进行封装，例如：

php
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function scopeThinkphp($query)
    {
        $query->where('name','thinkphp')->field('id,name');
    }
    public function scopeAge($query)
    {
        $query->where('age','>',20)->limit(10);
    }    
}

就可以进行下面的条件查询：

// 查找name为thinkphp的用户
User::scope('thinkphp')->find();
// 查找年龄大于20的10个用户
User::scope('age')->select();
// 查找name为thinkphp的用户并且年龄大于20的10个用户
User::scope('thinkphp,age')->select();

查询范围的方法可以定义额外的参数，例如User模型类定义如下：

php
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function scopeEmail($query, $email)
    {
        $query->where('email', 'like', '%' . $email . '%');
    }
    public function scopeScore($query, $score)
    {
        $query->where('score', '>', $score);
    }
}

在查询的时候可以如下使用：

// 查询email包含thinkphp和分数大于80的用户
User::email('thinkphp')->score(80)->select();

可以直接使用闭包函数进行查询，例如：

User::scope(function($query){
    $query->where('age','>',20)->limit(10);
})->select();

使用查询范围后，只能使用find或者select查询。

全局查询范围

如果你的所有查询都需要一个基础的查询范围，那么可以在模型类里面定义一个静态的base方法，例如：

php
namespace app\index\model;
use think\Model;
class User extends Model
{
    // 定义全局的查询范围
    protected function base($query)
    {
        $query->where('status',1);
    }
}

然后，执行下面的代码：

$user = User::get(1);

最终的查询条件会是

status = 1 AND id = 1

如果需要动态关闭/开启全局查询访问，可以使用：

// 关闭全局查询范围
User::useGlobalScope(false)->select();
// 开启全局查询范围
User::useGlobalScope(true)->select();

V5.1.26+版本开始，支持在模型里面设置globalScope属性，定义全局的查询范围

php
namespace app\index\model;
use think\Model;
class User extends Model
{
    // 定义全局的查询范围
    protected $globalScope = ['status'];
    public function scopeStatus($query)
    {
        $query->where('status',1);
    }
}

或者使用useGlobalScope方法动态指定当前查询的全局查询范围。

User::useGlobalScope(['status'])->select();